home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / backup / sback1.exe / SBACK1.DOC < prev    next >
Text File  |  1993-06-08  |  21KB  |  528 lines
  1. This README of SBACK1.ZIP is for NetWare v3.1x.  The following files are
  2. included in this revision:
  3.  
  4.     WANGTEK.NLM         15681     7-18-91     3:37p
  5.     DIBIDAI.NLM         15527     7-23-92     2:14p
  6.     NOVADIBI.NLM        17119     3-31-92    12:08p
  7.     SIDR.NLM            17192     8-21-92    12:03p
  8.     TSA-310.NLM        105836     4-03-92     9:20a
  9.     TSA-311.NLM        106267     4-03-92     9:13a
  10.     TSA.NLM             27047     4-03-92     2:59p
  11.     SBACKUP.NLM        183043     3-05-92     2:00p
  12.     TAPEDAI.DSK         28838     2-08-93     5:08p
  13.     PHYSADDR.DSK          487    12-09-92    16:22p
  14.     SME-SHIM.NLM         1148     3-04-92     8:09a
  15.     SBACKUP.PCL         38199     1-15-92    11:46a(DOCUMENTATION) 
  16.     SBACKUP.NFO        178176     3-12-92     3:38p(DOCUMENTATION)
  17.     SBACK1.DOC          THIS FILE (Revision 1.0)
  18.  
  19.  
  20. SBACKUP v3.11b Maintenance Update
  21.     These are some of SBACKUP'S fixes and enhancements. 
  22.     
  23. Documentation
  24.     This update contains revised user documentation (Folioformat).To
  25.     view this documentation simply copy theSBACKUP.NFO file to the
  26.     directory where NFOLIO.EXE is located( usually SYS:PUBLIC).
  27.     Execute Nfolio.exe and select SBACKUPfrom the main menu.
  28.  
  29. 3.10 NetWare support
  30.     A TSA for 3.10 NetWare is now available. Load TSA-310.NLM and 
  31.     SME-SHIM.NLM on the 310 server you are backing up.
  32.  
  33. File location
  34.     The subdirectory structure under the SYS:SYSTEM directory
  35.     is not required to load NLMs. All NLMs may reside in the
  36.     SYS:SYSTEM directory*.  
  37.  
  38.     The directories SYS:SYSTEM\TSA (for temporary file use) and 
  39.     SYS:SYSTEM\DIBI (for DIBI2$DV.DAT file) must exist. 
  40.  
  41.     *If the SIDR, DIBI and TSA directories are used, search paths
  42.     must be added to these directories using the SEARCH ADD
  43.     [path]command.
  44.  
  45. Restore
  46.      New restore option:
  47.       Include File Server Level - see new user document.
  48.  
  49.       Bindery is NOT restored unless specifically included
  50.       using the "Include File Server Level" options.
  51.  
  52. Maintenance Improvements
  53.      » It runs faster.  
  54.      » Errors no longer appear when trying to restore a directory 
  55.        that does not exist. 
  56.      » Corrected NameSpace data error on FTAM and NFS.
  57.      » Improved file open modes.
  58.      » Changed SMS to work on a server after the SECURE CONSOLE  command. 
  59.      » Corrected ABEND using SYS:\ as the working directory.
  60.      
  61. To install this new SBACKUP and supported files:
  62.      1. Flag all SBACKUP files SRW in SYS:SYSTEM.
  63.      2. Rename the SBACKUP files to *.old.
  64.      3. Copy all files to the SYS:SYSTEM directory. (In this new
  65.     version of SBACKUP, all NLMs can be loaded from the system
  66.     directory*).
  67.  
  68.     *If the SIDR, DIBI and TSA directories are used, search
  69.      paths must be added to these directories using the
  70.      SEARCH ADD [path]command.
  71.     
  72.      4. Flag the files back to ROS.
  73.  
  74. Explanation of TAPEDAI and DIBIDAI files:
  75.  
  76. TAPEDAI.DSK
  77.     
  78.     TAPEDAI.DSK is a NetWare 386 device driver written to control
  79.     certain tape devices.  It is used with DIBIDAI.NLM.
  80.  
  81.     PHYSADDR.DSK is a support file for TAPEDAI.DSK and must be loaded
  82.     prior to loading TAPEDAI.DSK.
  83.  
  84.     DIBIDAI.NLM presents a DIBI interface to SBACKUP.NLM, but
  85.     translates the DIBI requests into NetWare DAI calls.  This 
  86.     eventually results in device driver calls getting passed to 
  87.     TAPEDAI.DSK through the same IO request mechanism used byNetWare
  88.     to obtain disk service.
  89.  
  90.     TAPEDAI.DSK must be loaded prior to loading SBACKUP. If it is
  91.     used often, the user may want to load it from within the
  92.     STARTUP.NCF file.
  93.  
  94.     In order to use TAPEDAI.DSK and DIBIDAI.NLM the DIBI2$DV.DAT 
  95.     file in SYS:SYSTEM\DIBI must be edited to include DIBIDAI.NLM.  
  96.     The DIBI2$DV.DAT file is a DOS text file and can be edited 
  97.     using EDIT.NLM or with any DOS text editor from a workstation.
  98.     
  99.     Editing the Dibi2$dv.dat file in the system\dibi subdirectory:
  100.  
  101.     1.  Flag the file as read/write.
  102.     2.  Use a text editor to edit the file. If editing the file 
  103.         using the EDIT.NLM type: 
  104.              "LOAD EDIT SYS:SYSTEM\DIBI\DIBI2$DV.DAT" 
  105.         at the console prompt.
  106.     3.  When the file is brought up it will look like this:
  107.    
  108.         "Wangtek Tape Drive."       WANGTEK  PORT=280 DMA=3 IRQ=5
  109.         "HP DIBI-2 Tape Driver."    NOVADIBI
  110.         "DC00 DIBI-2 Tape Driver."  TAPEDC00
  111.  
  112.         A line like the following will need to be added:
  113.  
  114.         "DibiDai Driver."           DibiDai
  115.  
  116.         The description on the left can be anything.  The DibiDai 
  117.         on the right refers to the the DibiDai.nlm that comes with
  118.         Sback.zip.  
  119.         
  120.     4.  Exit the editor and save changes.   
  121.  
  122.  
  123. Dependencies:
  124.  
  125.     TAPEDAI.DSK targets any ASPI compliant disk drivers.  Check with
  126.     the driver manufacturer to confirm ASPI compliancy.
  127.  
  128.     Consequently,  the ASPI compliant disk driver must be loaded 
  129.     prior to loading TAPEDAI.DSK. 
  130.  
  131. Target Devices:
  132.     TAPEDAI only works with the following devices:
  133.  
  134.     Manufacturer    Product                 
  135.  
  136.     ARCHIVE         Python
  137.     CIPHER          T826 (half inch - 2.6 Gig)
  138.     CIPHER          T860 (half inch - 6 Gig)
  139.     EXABYTE         EXB-8500                        
  140.     HP              HP35450A                        
  141.     HP              HP35470A*                       
  142.     HP              HP35480A*
  143.     TANDBERG        TDC 3800
  144.     TANDBERG        TDC 4100
  145.     TANDBERG        TDC 4200
  146.     WANGDAT         1300
  147.     WANGDAT         3200
  148.     WANGTEK         5525ES
  149.     WANGTEK         6130
  150.     WANGTEK         WANGTEK_6130_HS 
  151.  
  152.        *(The HP35470A and HP35480A must be set through its dip switches
  153.        so that the SCSI Valid Bit is set upon crossing Early Warning.
  154.        If this is not done, sessions that span tapes won't be reliable.
  155.        Users should perform a test backup and restore across tapes to
  156.        confirm that the switches are set properly.  The file that
  157.        actually spans tapes is the one to test.)
  158.  
  159. NOVADIBI.NLM
  160.     
  161.     DIBI-2 interface driver that works with devices and drivers
  162.     that are DIBI-2 compatible.  Controller driver must support
  163.     the DIBI-2 interface.  Contact specific hardware vendor to
  164.     determine DIBI-2 driver compatibility.
  165.  
  166. SIDR.NLM        
  167.     Storage Independent Data Requester.  Controls transfer of data
  168.     between backup engine and the TSA.
  169.  
  170. TSA Files
  171.     TSA.NLM
  172.         Target Service Agent.  Interface used by SIDR.NLM to
  173.         gather data from the target server.
  174.  
  175.     TSA-311.NLM
  176.         Target Service Agent for 3.11 server to be backed up.  
  177.         Provides link between TSA.NLM and specific 3.11 target 
  178.         server.
  179.  
  180.     TSA-310.NLM
  181.         Target Service Agent for 3.10 server to be backed up.  
  182.         Provides link between TSA.NLM and specific 3.10 target 
  183.         server.  Must be used in conjunction with SME-SHIM.NLM.
  184.  
  185.     SME-SHIM.NLM
  186.         Support file for TSA-310.NLM.
  187.  
  188.  
  189. **********************
  190. * A WORD OF CAUTION: *
  191. **********************
  192.  
  193. At the present time SBackup does NO READ-AFTER-WRITE verification of the
  194. data that is backed up.  Therefore it is important that you verify your
  195. backups manually.  One way of accomplishing this is to follow example 1
  196. in the Commonly Asked Questions section -- "How to Restore a file to a
  197. new location."  Restoring several files to a new location and doing a DOS
  198. compare on the restored files with their originals will verify that files
  199. are being backed up correctly and that they can be restored.  It should
  200. be kept in mind that this in no way represents a complete verification.
  201. It is recommended that you do this with every backup set that you make
  202. and should be made a regular step in your backup procedures.
  203.  
  204. Driver Implementation
  205. ╔═════════════════════════╤════════════════════╤════════════════════╤═════════╗
  206. ║Driver From              │Driver From         │Sbackup Interface   │Multiple ║
  207. ║Novell                   │Vendor              │Software            │Device   ║
  208. ║                         │                    │                    │Support  ║
  209. ╟─────────────────────────┼────────────────────┼────────────────────┼─────────╢
  210. ║TAPEDAI.DSK &            │Any ASPI compliant  │DIBIDAI.NLM (Driver │YES      ║
  211. ║PHYSADDR.DSK             │Disk Driver*        │must be added to    │         ║
  212. ║                         │                    │DIBI2$DV.DAT file   │         ║
  213. ║                         │                    │-- see above        │         ║
  214. ║                         │                    │TAPEDAI.DSK         │         ║
  215. ║                         │                    │explanation)        │         ║
  216. ╟─────────────────────────┼────────────────────┼────────────────────┼─────────╢
  217. ║B/R Driver Kit NLMs.     │N/A                 │DC00 DIBI-2 Tape    │NO       ║
  218. ║(Only Adaptec.NLM        │                    │Driver              │         ║
  219. ║Ships w/3.11 -- see      │                    │(TapeDC00.NLM)      │         ║
  220. ║following list for other │                    │                    │         ║
  221. ║available drivers)       │                    │                    │         ║
  222. ╟─────────────────────────┼────────────────────┼────────────────────┼─────────╢
  223. ║N/A                      │Any DIBI-2          │HP DIBI-2 Tape      │YES      ║
  224. ║                         │Compliant Disk      │Driver              │         ║
  225. ║                         │Driver*             │(NovaDibi.NLM)      │         ║
  226. ╟─────────────────────────┼────────────────────┼────────────────────┼─────────╢
  227. ║WANGTEK.NLM              │N/A                 │Wangtek Tape Drive  │N/A      ║
  228. ║(Support for             │                    │(Wangtek.NLM)       │         ║
  229. ║Wangtek's QIC-02         │                    │                    │         ║
  230. ║controllers)             │                    │                    │         ║
  231. ╟─────────────────────────┼────────────────────┼────────────────────┼─────────╢
  232. ║N/A                      │N/A                 │CPQSCSIT.NLM Tape   │YES      ║
  233. ║                         │                    │driver from Compaq. │         ║
  234. ║                         │                    │(Must be added to   │         ║
  235. ║                         │                    │DIBI2$DV.DAT file)  │         ║
  236. ║                         │                    │                    │         ║
  237. ║                         │                    │                    │         ║
  238. ╟─────────────────────────┼────────────────────┼────────────────────┼─────────╢
  239. ║PS2OPT.DSK dated         │N/A                 │DIBIDAI.NLM (Driver │YES      ║
  240. ║February 4, 1993 or      │                    │must be added to    │         ║
  241. ║later                    │                    │DIBI2$DV.DAT file   │         ║
  242. ║                         │                    │-- see above        │         ║
  243. ║                         │                    │TAPEDAI.DSK         │         ║
  244. ║                         │                    │explanation)        │         ║
  245. ╚═════════════════════════╧════════════════════╧════════════════════╧═════════╝
  246. *For verification of ASPI or DIBI-2 compliant disk drivers check with
  247.  driver vendor.
  248.  
  249. File Implementation:
  250.  
  251.     Sbackup can control tape devices with the following
  252.     configurations:
  253.  
  254.     1. B/R Driver Kit NLMs.  Adaptec.Nlm is provided with 3.11.
  255.        The Adaptec.Nlm driver will control a single tape device
  256.        off of either an Adaptec 154x , 164x or a 174x in standard
  257.        mode.
  258.         Limitations:
  259.         » Support for only one device connected to
  260.           controller.
  261.         » Controller must be set to port address 330.
  262.  
  263.     Support is also available for the following controllers with
  264.     the purchase of Novell's B/R Driver Kit (Part #153-000179-001):
  265.  
  266.     THE B/R DRIVER KIT NLMs ALLOW ONLY A SINGLE DEVICE (I.E.SINGLE
  267.     TAPE DEVICE ONLY -- NO HARD DRIVES) TO BE CONNECTED TO THE
  268.     CONTROLLER.
  269.  
  270. Host Adapter                            Bus           Interface
  271. ----------------------------------------------------------------
  272. 3COM SCSI Plus                          ISA             SCSI
  273. Adaptec AHA-1520                        ISA             SCSI
  274. Adaptec AHA-1540                        ISA             SCSI
  275. Adaptec AHA-1542                        ISA             SCSI
  276. Adaptec AHA-1640                        MC              SCSI
  277. Adaptec ASPI SCSI Manager                               SCSI
  278. Archive VP402                           ISA             QIC-02
  279. Archive VP409A                          MC              QIC-02
  280. BusTek BT-542B                          ISA             SCSI
  281. BusTek BT-642B                          MC              SCSI
  282. BusTek BT-742A                          EISA            SCSI
  283. Future Domain MCS-350                   MC              SCSI
  284. Future Domain TMC-845                   ISA             SCSI
  285. Future Domain TMC-850                   ISA             SCSI
  286. Future Domain TMC-860                   ISA             SCSI
  287. IBM SCSI Host Adapter                   MC              SCSI
  288. NetFRAME SCSI Adapter                                   SCSI
  289. Tecmar PC-02                            ISA             QIC-02
  290. Tecmar PC-02                            MC              QIC-02
  291. Tricord IIOP                                            SCSI
  292.  
  293.         With the B/R driver kit the NLMs can be configured for
  294.         the specific controller settings.
  295.  
  296.         Implementation:     
  297.             »  The NLM is loaded prior to loading Sbackup.  
  298.             »  After loading Sbackup select the Tape DC00
  299.                driver.
  300.             NOTE:  No other driver should be loaded for the
  301.                    controller when using the B/R driver NLMs.
  302.        
  303.         2. NovaDibi.Nlm provides tape backup support when used
  304.            in conjunction with a disk driver that is DIBI-2
  305.            compatible (to verify DIBI-2 compatibility check with
  306.            disk driver manufacturer).  With the NovaDibi.nlm
  307.            driver multiple devices can be connected to the
  308.            controller.
  309.              Implementation:
  310.               » Load DIBI-2 compliant disk driver before
  311.                 loading Sbackup.
  312.               » Load TSA.
  313.               » Select the HP-Dibi2 Tape Driver option in
  314.                 Sbackup.
  315.  
  316.            This driver was developed initially for the HP DAT
  317.            drives.  Caution should be used when using a
  318.            "Non-DAT" drive.  Errors could occur when multiple
  319.            sessions are backed up to a single tape.
  320.  
  321.         3. TapeDai.DSK and PhysAddr.Nlm provide tape backup
  322.            support when used in conjunction with an ASPI
  323.            compliant disk driver (to verify disk driver's ASPI
  324.            compliancy contact driver manufacturer).
  325.  
  326.             Implementation:
  327.                 »  Load ASPI compliant disk driver.
  328.                 »  Load PHYSADDR.DSK
  329.                 »  Load TapeDai.Dsk.
  330.                 »  Select DibiDai.Nlm option that was
  331.                    added to DIBI2$DV.DAT file (for
  332.                    instructions on how to edit file
  333.                    see note about DibiDai.Nlm file
  334.                    above).
  335.  
  336.                NOTE:  If the tape drive being used is not in the
  337.                   list of tape drives supported by TapeDai.Dsk
  338.                   this configuration will NOT work.
  339.  
  340.         4. Wangtek.Nlm.  Provides tape backup support for Wangtek's
  341.            QIC-02 tape devices.  The default setting for the driver
  342.            is Port=280, DMA=3, IRQ=5.  If the   QIC-02 adapter is
  343.            set to anything other than these   settings the
  344.            DIBI2$DV.DAT file will need to be edited (see
  345.            instructions above for editing the DIBI2$DV.DAT file).
  346.  
  347.         5. PS2Opt.Dsk dated February 4, 1993 and DIBIDAI.NLM.
  348.            This driver is included in documentation due to its
  349.            unique implementation.
  350.                 » Load PS2Opt.Dsk.
  351.                 » Load TSA
  352.                 » Load Sbackup
  353.                 » Select DibiDai.Nlm option that was
  354.                   added to DIBI2$DV.DAT file (for
  355.                   instructions on how to edit file see
  356.                   note about DibiDai.Nlm file above).
  357.  
  358.            Requirements:
  359.               » PS2OPT.DSK dated 02-04-93 or later.
  360.               » PS2OPT.DSK has only been tested with the
  361.                 following devices:
  362.                  1.  Exabyte 8200, 8mm
  363.                  2.  Exabyte 8500, 8mm
  364.                  3.  HP 35470, 4mm DAT
  365.                  4.  HP 35480A, 4mm DAT
  366.                  5.  HP 35450A, 4mm DAT
  367.                  6.  WangDat 3200, 4mm DAT
  368.                  7.  WangDat 1300, 4mm DAT
  369.                  8.  Archive Python, 4mm DAT
  370.                  9.  Cipher T860s, 1/2 inch tape
  371.  
  372.         6. CPQSCSIT.NLM.  Driver can be found on Compaq's Netware
  373.            Programs diskette or the latest driver can be obtained
  374.            from Netwire -- CPQTAP.ZIP in library 13.  This driver
  375.            allows Sbackup to function with the following Compaq 
  376.            tape drives:
  377.  
  378.            Drive Name                           Part Number
  379.            320-/525-MG Tape Drive               116573-001
  380.            1.3-/2.0-GB DAT Drive                131162-001
  381.  
  382.            In order to use this driver the DIBI2$DV.DAT file in the
  383.            SYS:SYSTEM\DIBI subdirectory must be editted (see note
  384.            for editting the DIBI2$DV.DAT file above).  
  385.  
  386.            If server is EISA based the following line will need to
  387.            be added:
  388.  
  389.            "Compaq SCSI Tape Driver."              CPQSCSIT
  390.  
  391.            If server is ISA base the following line will need to be
  392.            added:
  393.  
  394.            "Compaq SCSI Tape Driver."   CPQSCSIT PORT=xxx DMA=x IRQ=x
  395.  
  396.            The x's after PORT, DMA and IRQ should be replaced with
  397.            the actual setting of the SCSI tape adapter.  CPQSCSIT 
  398.            should also be lined up with the other driver names in
  399.            the DIBI2$DV.DAT file.
  400.  
  401.            Implementation:
  402.             » Load TSA
  403.             » Load Sbackup
  404.             » Select Compaq Option that was added to the 
  405.               DIBI2$DV.DAT file.
  406.  
  407.  
  408. Commonly Asked Questions:
  409.     
  410.     1.  How to restore a file to a new location.
  411.  
  412.      From the Sbackup Restore Options Menu select "Selection List
  413.      Options."
  414.         With the "Include Directories" Option insert the name
  415.         of the subdirectory that files are to be redirected TO
  416.         (i.e. the destination subdirectory).
  417.  
  418.         With the "Include and Exclude File" Options select
  419.         specific files to be redirected.
  420.  
  421.         With the "Destination Paths" Option insert the"Source"
  422.         and "Destination" paths.
  423.  
  424.         Start the Restore.
  425.  
  426.         EXAMPLE:
  427.  
  428.         Files that were backed up in the SYS:FIRST subdirectory
  429.         with the file specification of *.DATneed to be restored
  430.         to the VOL1:SECOND subdirectory.On the Sbackup Restore
  431.         Options Menu select"Selection List Options."
  432.  
  433.         Set the "Include Directories" Option to VOL1:SECOND --
  434.         the name of the destination subdirectory.
  435.  
  436.         Set the "Include Files" Option to *.DAT -- the file
  437.         specification to be restored.
  438.  
  439.         Escape back to the Restore Options Menu and select
  440.         "Destination Paths."
  441.  
  442.         Press Insert and enter the "Path Source" as SYS:FIRST.
  443.         Enter the "Path Destination " as VOL1:SECOND.
  444.  
  445.         Start the Restore.
  446.  
  447.  
  448.     2.  How to Restore specific files.
  449.  
  450.         From the Sbackup Restore Options Menu select "Selection
  451.         List Options."
  452.  
  453.         With the "Include Directories" Option insert the
  454.         directory in which the file to be restored resided when
  455.         it was backed up.  If you don't know leave this option
  456.         blank -- all directories will be searched for the include
  457.         files specified.
  458.  
  459.         With the "Include Files" Option insert the filenames to be
  460.         restored.  Wild cards (* and ?) can be used.
  461.  
  462.         Start the Restore.
  463.  
  464.         EXAMPLE:
  465.  
  466.         The entire SYS:TEMP subdirectory was deleted and purged.
  467.         The entire subdirectory does not need to be restored only
  468.         spreadsheet files need to be restored.
  469.  
  470.         On the Sbackup Restore Options Menu select "Selection
  471.         List Options."
  472.  
  473.         The "Include Directories" option would be set to SYS:TEMP.
  474.         This will prevent Sbackup from restoring all instances of
  475.         the spreadsheet files.
  476.  
  477.         The "Include Files" option would be set to *.WKS, the
  478.         extension of the spreadsheet files.
  479.  
  480.         Start the Restore.
  481.  
  482.     3.  In the "Selection List Options" which takes precedence over
  483.         the other "Include" or "Exclude"?
  484.  
  485.         The "Exclude" option takes precedence over the"Include"
  486.         option.  However, whenever the "Include"option is used
  487.         all "Non-included" files are excluded anyway.
  488.  
  489.     4.  In the "Selection List Options" what is the difference between
  490.         the Include/Exclude files options and Include/Exclude
  491.         Path/Files on the "Selection List Options"?
  492.  
  493.         The Include/Exclude Files options are used to restore
  494.         files that reside anywhere in the directory structure.
  495.         When used in conjunction with the Include/Exclude
  496.         Subdirectories options specific file paths can be restored
  497.         (see #2 above -- Restoring specific files).
  498.  
  499.         The Include/Exclude Path/Files options are used to restore
  500.         files to the specific location in the directory structure
  501.         from which they were backed up.  Regardless of the paths
  502.         specified the entire directory structure will be scanned.
  503.         Any subdirectories that were on the backup tape and not on
  504.         the server being restored will be created.
  505.  
  506. ***************************************************************** 
  507.             DISCLAIMER  
  508.   
  509. Novell, Inc. makes no representations or warranties with respect to
  510. any NetWare software, and specifically disclaims any express or
  511. implied warranties of merchant ability, title, or fitness for a
  512. particular purpose.  
  513.  
  514. Distribution of any NetWare software is forbidden without the
  515. express written consent of Novell, Inc.  Further, Novell reserves
  516. the right to discontinue distribution of any NetWare software.
  517.  
  518. Novell is not responsible for lost profits or revenue, loss of use
  519. of the software, loss of data, costs of re-creating lost data, the
  520. cost of any substitute equipment or program, or claims by any party
  521. other than you.  Novell strongly recommends a backup be made before
  522. any software is installed.   Technical support for this software
  523. may be provided at the discretion of Novell.
  524. *****************************************************************
  525.    
  526.  
  527.  
  528.